<style type="text/css">
<!--
.style1 {
	font-size: 24px;
	font-weight: bold;
}
-->
</style>
<p align="center" class="style1">Messaging Service API - Example Widget Documentation</p>
<hr />
<h3><strong>About this document</strong></h3>
<p>This document describes the Messaging  Widget application for   S60 5th Edition SDK. Read this document if you are a web developer, testing professional, or   the product manager working on this product. </p>
<h3><strong>About this Product</strong></h3>
<p>Widgets are lightweight Web applications developed using the same well-known   standards-based Web technologies &ndash; AJAX, CSS, HTML and JavaScript &ndash; used to   create Web pages. Developers can use it as a reference and testers can use it to   test the relevant functionality. This widget is intended for S60 5th Edition SDK. Developers   should be able to develop professional applications.</p>
<h3><strong>Product intent</strong></h3>
<p>Example Widget Application is designed to run on S60 5.0 SDK. It will be designed   such that a developer takes it as a reference to create useful applications for   any functionality supported on SDK. It will be designed to let the testers to   test the functionality</p>
<h3><strong>Product limitations</strong></h3>
<p>Example widget is not intended to give full featured implementation. This   example will implement the Messaging Service APIs. It gives only messaging functionalities. It only lists the Draft messages from the Draft folder. </p>
<h2><strong>Specification</strong></h2>
<p>The example widget uses the WRT 1.0 API. The Web Runtime (WRT) environment   supports the following Internet technology standards:<br />
    <br />
  HTML 4.01<br />
  The   basic HTML standards are supported.<br />
  <br />
  XHTML 1.0<br />
  The basic XHTML   standards are supported.<br />
  <br />
  CSS Level 2 revision 1 (CSS   2.1)<br />
  <br />
  JavaScript 1.5 (ECMA-262 3rd Edition) <br />
  The standard JavaScript   features are supported. The WRT environment also provides some additional   features that are mobile device specific. <br />
  The following additional   JavaScript features are supported in the WRT environment:</p>
<ul>
  <li>Utilizing the underlying user input features of the mobile device to   interact with the user </li>
  <li>Self-updating widgets </li>
  <li>UI navigation using either a cursor or tabs </li>
  <li>Rotating the screen: portrait and landscape orientation </li>
  <li>Launching S60 mobile applications </li>
  <li>Localization framework with automatic detection of the device language   settings </li>
  <li>Getting information on physical device functionality and controlling such   features. </li>
</ul>
<h3><strong>Example Description</strong></h3>
<p>The MessagingWidget demonstrates messaging functionalities given by the Messaging Service APIs. The Widget provide you the UI to select the options to list the Draft messages, Send Sync and ASync messages, Delete specific message if valid message id is provided and also Change the status of the message. </p>
<h3><strong>Use Cases</strong></h3>
<ul>
  <li>List the Draft folder messages </li>
  <li>Sends Async messages and put the message into Sent folder.</li>
  <li>Send Sync messages and put the message into Sent folder.</li>
  <li>Delete the message based on the messsage id provided.</li>
  <li>Change the status of the message based on the message id provided.<br />
  </li>
</ul>
<h3><strong>User Interface</strong></h3>
<p>1. Use the file - Open option to open the widget under   &lt;Installed-5th-Edition-SDK&gt;\S60WidgetExamples\MessagingWidget.wgz.</p>
<p>2. Go to Application folder and click on the MessagingWidget to start. Once you start the widget, it will ask your application permission to access data.</p>
<p align="center"><img src="docfiles/mw0.JPG" alt="Application Permission to Access data" width="369" height="630" /> </p>
<p align="left">&nbsp;</p>
<p align="left">3. Once your widget is started, you can see the following user ineterface with the list of options.</p>
<p align="center"><img src="docfiles/m1.png" alt="Main page - List of Options" width="364" height="636" /> </p>
<p align="left">&nbsp;</p>
<p align="left">4. First options will give you list of SMS/MMS in the Draft Folder in the same page. You can scroll down the page to see the SMS/MMS details.</p>
<p align="center"><img src="docfiles/m2.png" alt="List of SMS/MMS from the Draft folder" width="362" height="624" /> </p>
<p align="left">&nbsp;</p>
<p align="left">5. Second and third options is so send SMS/MMS. Once you click on that, it will send Sync/ASync MMS respectively and saves the copy of sent item to the Sent folder.</p>
<p align="center"><img src="docfiles/m3.png" alt="Sends Sync.ASync MMS respectively" width="364" height="630" /></p>
<p align="left">&nbsp;</p>
<p align="left">6. Forth options is to delete the SMS/MMS. You need to provide the Message id which you want to delete. Once you click on the MsgId text box, it will open the window to input the message id. Once you refresh the message list by 'Get Message List' option, It will give you the updated list with the deleted message. </p>
<p align="center"><img src="docfiles/mw4.JPG" alt="Input the message id here" width="363" height="640" /> </p>
<p align="left">7. You can also change the status of the message wheather it is Read or Unread by 'Change Status' option. You need to provide the message id.</p>
<h2><strong>Internationalization</strong></h2>
<p>Example Widget Application does not support internationalization</p>
<h2><strong>References</strong></h2>
<a href="http://www.forum.nokia.com/main/resources/technologies/browsing/widgets.html">Web   Runtime environment and widgets</a><br />
<a href="http://www.forum.nokia.com/info/sw.nokia.com/id/fd9cc12e-5eed-40ec-a439-c77f845fed73/Web_Developers_Library.html">Web   Developer's Library 1.0</a>
<p align="left">&nbsp;</p>
